If the image to load is a DIB or BMP, setting the hDIB property (or the hDIB64 Property for 64-bit environments) loads the image. If the image is a BMP, a call to hDIB converts the bitmap to a DIB and stores at hDIB.

The image can be accessed as a device dependent bitmap by calling ToHBitmap. 

Note that ToHBitmap does not load an image. When ToHBitmap is called, the current DIB is converted to a device dependent bitmap and stored at ToHBitmap. Therefore, the value of ToHBitmap may change in subsequent calls, if the DIB has been modified.

The OwnDIB property specifies whether ImagXpress® should make a copy of the DIB during loading, or use the source DIB at the source location. 

• If the OwnDIB property is False, when loading a DIB using hDIB, then ImagXpress stores a copy of the source DIB at a new location and assigns hDIB to this location. Processing of the loaded DIB will not result in modifications in the source DIB. 
• If the OwnDIB property is True, when loading a DIB using hDIB, then ImagXpress stores the source DIB handle in the ImagXpress buffer and subsequent processing of the image results in modification of the source DIB.  

Note that when a DIB loads by setting hDIB, the display is not immediately updated. The display will update to the new DIB the next time the display paints.

©2019. Accusoft Corporation. All Rights Reserved.